Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-001 |
| Deskripsi | Halaman utama brand yang menampilkan performa bisnis lewat widget keuangan (biaya usaha, pendapatan, laba rugi, arus kas, margin, sisa hutang/piutang) dan kartu ringkasan hutang/piutang, beserta panduan cara memulai |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User membuka dashboard brand dan berpindah antara tab Performa Bisnis, Cara Memulai, dan Promosi
- User mengikuti panduan Cara Memulai: progres pengisian master data (barang, customer, supplier, metode bayar, inisiasi neraca awal), membuat invoice pertama, dan mencatat pengeluaran pertama
- User mengatur widget dan kartu ringkasan yang tampil (per item atau tampilkan semua), sesuai hak akses
- User mengatur ulang posisi widget dengan drag and drop
- User melihat widget berbasis laba rugi: biaya usaha, total pendapatan, laba rugi tahunan, komponen laba rugi, Net Profit Margin, serta perkembangan penjualan dan laba rugi, dengan filter bulan atau tahun
- User melihat widget arus kas (kas masuk, kas keluar, saldo awal, saldo akhir) per tahun
- User melihat sisa hutang per supplier dan sisa piutang per customer pada tanggal tertentu
- User melihat kartu ringkasan total hutang dan total piutang, termasuk yang jatuh tempo hari ini dan yang sudah lewat jatuh tempo
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan dashboard brand dengan tab Performa Bisnis, Cara Memulai, dan Promosi |
| FR-02 | Sistem menampilkan progres panduan Cara Memulai berdasarkan status tour pada konfigurasi brand dan menandai tutorial selesai saat user memilih membuat dashboard pribadi |
| FR-03 | User dapat memilih widget dan kartu ringkasan yang tampil, hanya untuk item yang diizinkan hak aksesnya |
| FR-04 | User dapat mengaktifkan mode drag dan menukar posisi widget |
| FR-05 | Sistem menampilkan widget berbasis laporan laba rugi sesuai periode bulan atau tahun yang dipilih |
| FR-06 | Sistem menampilkan widget arus kas dari akun kas dan bank beserta saldo awal periode |
| FR-07 | Sistem menampilkan sisa hutang per supplier dan sisa piutang per customer pada tanggal yang dipilih |
| FR-08 | Sistem menampilkan kartu ringkasan total hutang dan total piutang, jatuh tempo hari ini, dan lewat jatuh tempo |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Membuka dashboard dan berpindah tab |
| UC-02 | Mengikuti panduan cara memulai |
| UC-03 | Mengatur widget dan kartu ringkasan yang tampil |
| UC-04 | Mengatur posisi widget |
| UC-05 | Melihat widget laba rugi per periode |
| UC-06 | Melihat widget arus kas tahunan |
| UC-07 | Melihat sisa hutang dan sisa piutang |
| UC-08 | Melihat kartu ringkasan total hutang dan piutang |
4. Use Case Scenario
UC-01 : Membuka dashboard dan berpindah tab
| Aktor | User brand |
| Deskripsi | User membuka halaman utama brand dan memilih tab yang ingin dilihat |
| Prekondisi | User sudah login dan berada di konteks brand aktif |
| Alur utama | 1. User membuka halaman utama brand. 2. Sistem menampilkan tab Cara Memulai sebagai default. 3. Jika tutorial brand sudah selesai, sistem langsung membuka tab Performa Bisnis. 4. User berpindah ke tab Performa Bisnis, Cara Memulai, atau Promosi. |
| Alur negatif | - Jika user membuka tab selain Performa Bisnis, tombol Atur Widget disembunyikan. - Jika data brand belum termuat, progres panduan tetap di langkah awal. |
| Bisnis rule | - Tab default adalah Cara Memulai, kecuali konfigurasi brand menandai tutorial sudah selesai. - Tombol Refresh dan Reset Periode tampil di tab Performa Bisnis. |
| Postkondisi | Tab dashboard yang dipilih tampil |
| Trigger | User masuk ke brand |
| Kode FR | FR-01 |
UC-02 : Mengikuti panduan cara memulai
| Aktor | User brand |
| Deskripsi | User melihat progres persiapan data awal dan diarahkan ke halaman terkait |
| Prekondisi | User berada di tab Cara Memulai |
| Alur utama | 1. User membuka langkah Setting Master Data. 2. Sistem menampilkan progres langkah barang, customer, supplier, metode bayar, dan inisiasi neraca awal. 3. User memilih langkah dan diarahkan ke halaman master terkait. 4. Pada langkah Buat Faktur Pertama, user memilih buat invoice penjualan atau pembelian dengan mode tour aktif. 5. Pada langkah Catat Pengeluaran Pertama, user diarahkan ke transaksi kas bank. 6. User memilih Buat Dashboard Pribadi Anda. 7. Sistem menandai tutorial selesai dan membuka tab Performa Bisnis. |
| Alur negatif | - Jika gagal menyimpan status tutorial selesai, sistem tetap membuka tab Performa Bisnis dan menampilkan log gagal di console. |
| Bisnis rule | - Progres dihitung dari status tour di konfigurasi brand, maksimal sejumlah langkah yang tersedia. - Status tutorial selesai hanya disimpan jika belum pernah ditandai. |
| Postkondisi | User diarahkan ke halaman langkah terkait atau tutorial ditandai selesai |
| Trigger | User memilih langkah di panduan |
| Kode FR | FR-02 |
UC-03 : Mengatur widget dan kartu ringkasan yang tampil
| Aktor | User brand |
| Deskripsi | User memilih widget dan kartu ringkasan yang ditampilkan di Performa Bisnis |
| Prekondisi | User berada di tab Performa Bisnis |
| Alur utama | 1. User menekan tombol Atur Widget. 2. Sistem menampilkan daftar widget dan summary card yang diizinkan. 3. User mencentang item satu per satu atau memilih Tampilkan Semua. 4. Sistem menampilkan item terpilih di grid dan menyesuaikan lebar kolom per baris. |
| Alur negatif | - Jika user tidak punya hak akses sama sekali untuk satu kelompok, muncul teks "Tidak memiliki akses". - Klik di luar popup menutup popup Atur Widget. |
| Bisnis rule | - Widget: biaya usaha, total pendapatan, laba rugi tahunan, komponen laba rugi, arus kas, Net Profit Margin, perkembangan penjualan dan laba rugi, sisa hutang, sisa piutang. - Summary card: total hutang, total piutang. - Setiap item hanya muncul jika user punya permission widget atau summary terkait. - Pilihan widget belum disimpan ke server, sehingga kembali kosong saat halaman dibuka ulang. |
| Postkondisi | Grid dashboard menampilkan item yang dipilih |
| Trigger | User menekan Atur Widget |
| Kode FR | FR-03 |
UC-04 : Mengatur posisi widget
| Aktor | User brand |
| Deskripsi | User menukar posisi widget di grid |
| Prekondisi | Minimal dua widget tampil |
| Alur utama | 1. User menekan ikon panah untuk mengaktifkan mode drag. 2. User menarik widget ke posisi widget lain. 3. Sistem menukar posisi dan menghitung ulang lebar kolom. 4. User menekan ikon panah lagi untuk menonaktifkan mode drag. |
| Alur negatif | - Jika mode drag tidak aktif, widget tidak dapat dipindah. |
| Bisnis rule | - Posisi hanya berlaku di sesi halaman, tidak disimpan ke server. |
| Postkondisi | Urutan widget berubah |
| Trigger | User mengaktifkan mode drag |
| Kode FR | FR-04 |
UC-05 : Melihat widget laba rugi per periode
| Aktor | User brand |
| Deskripsi | User melihat ringkasan laba rugi dalam bentuk grafik sesuai periode |
| Prekondisi | Widget berbasis laba rugi sudah dipilih untuk tampil |
| Alur utama | 1. Sistem memuat widget dengan periode default. 2. User mengubah filter periode di header widget. 3. Sistem memuat ulang data laba rugi seluruh cabang dan cluster. 4. Sistem menampilkan grafik dan total. |
| Alur negatif | - Jika data kosong, widget menampilkan keadaan data tidak ditemukan. - Jika gagal memuat, loading berhenti dan widget tidak menampilkan grafik. |
| Bisnis rule | - Biaya usaha, komponen laba rugi, dan Net Profit Margin memakai filter bulan (default bulan ini, bisa satu bulan atau rentang bulan). - Total pendapatan, laba rugi tahunan, serta perkembangan penjualan dan laba rugi memakai filter tahun. - Biaya usaha diambil dari akun kelompok 5 dan 6 level sub kelompok. - Total pendapatan dari kelompok 4 dan 7, perkembangan penjualan dari kelompok 4 dan 5, komponen laba rugi dan laba rugi tahunan dari kelompok 4 sampai 9. - Data selalu untuk semua cabang dan semua cluster. |
| Postkondisi | Grafik widget tampil sesuai periode |
| Trigger | Widget ditampilkan atau periode diubah |
| Kode FR | FR-05 |
UC-06 : Melihat widget arus kas tahunan
| Aktor | User brand |
| Deskripsi | User melihat kas masuk dan kas keluar per periode beserta saldo awal dan akhir |
| Prekondisi | Widget arus kas sudah dipilih untuk tampil |
| Alur utama | 1. Sistem memuat daftar akun kas dan bank. 2. User memilih tahun di filter widget. 3. Sistem memuat total debet sebagai kas masuk dan total kredit sebagai kas keluar. 4. Sistem memuat saldo awal akun kas dan bank pada awal periode. 5. Sistem menampilkan grafik garis kas masuk dan keluar serta saldo akhir. |
| Alur negatif | - Jika daftar akun kas belum termuat, sistem memuat ulang sebelum menghitung. - Jika gagal memuat, loading berhenti tanpa grafik. |
| Bisnis rule | - Akun yang dihitung adalah akun neraca dengan awalan nomor 11 (kas dan bank). - Saldo akhir = saldo awal + kas masuk - kas keluar. |
| Postkondisi | Grafik arus kas tampil |
| Trigger | Widget ditampilkan atau tahun diubah |
| Kode FR | FR-06 |
UC-07 : Melihat sisa hutang dan sisa piutang
| Aktor | User brand |
| Deskripsi | User melihat daftar sisa hutang per supplier dan sisa piutang per customer |
| Prekondisi | Widget sisa hutang atau sisa piutang sudah dipilih untuk tampil |
| Alur utama | 1. User memilih tanggal di filter hari. 2. Sistem memuat total sisa hutang per supplier atau sisa piutang per customer pada tanggal tersebut. 3. Sistem memuat nama supplier atau customer terkait. 4. Sistem menampilkan daftar terurut dari sisa terbesar beserta total keseluruhan. |
| Alur negatif | - Jika tidak ada sisa hutang atau piutang, daftar kosong dan nama tidak dimuat. |
| Bisnis rule | - Daftar diurutkan menurun berdasarkan nilai sisa. - Nama supplier atau customer diambil termasuk yang tidak aktif. |
| Postkondisi | Daftar sisa hutang atau piutang tampil |
| Trigger | Widget ditampilkan atau tanggal diubah |
| Kode FR | FR-07 |
UC-08 : Melihat kartu ringkasan total hutang dan piutang
| Aktor | User brand |
| Deskripsi | User melihat total hutang atau piutang beserta yang jatuh tempo |
| Prekondisi | Summary card total hutang atau total piutang dipilih untuk tampil |
| Alur utama | 1. Sistem memuat total sisa hutang atau piutang brand. 2. Sistem memuat jumlah dan nilai yang jatuh tempo hari ini. 3. Sistem memuat jumlah dan nilai yang sudah lewat jatuh tempo. 4. Kartu menampilkan ketiga nilai. |
| Alur negatif | - Jika tidak ada data, nilai yang tampil nol. |
| Bisnis rule | - Hanya invoice dengan sisa minimal 0,01 yang dihitung. - Invoice berstatus draft tidak dihitung. |
| Postkondisi | Kartu ringkasan tampil |
| Trigger | Summary card ditampilkan |
| Kode FR | FR-08 |
5. Data Flow Diagram
DFD-01 — Data widget dashboard
6. Sequence Diagram
SD-01 — UC-01 : Membuka dashboard dan berpindah tab
SD-02 — UC-02 : Mengikuti panduan cara memulai
SD-03 — UC-03 : Mengatur widget dan kartu ringkasan yang tampil
SD-04 — UC-04 : Mengatur posisi widget
SD-05 — UC-05 : Melihat widget laba rugi per periode
SD-06 — UC-06 : Melihat widget arus kas tahunan
SD-07 — UC-07 : Melihat sisa hutang dan sisa piutang
SD-08 — UC-08 : Melihat kartu ringkasan total hutang dan piutang
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
PUT /brand/config/:id | existing | - |
GET /financial-report/widget | existing | - |
GET /rekening | existing | - |
POST /buku-besar/saldo-awal/bulk | existing | - |
GET /invoice-hutang/sisa-hutang-by-supplier | existing | - |
GET /invoice-piutang/sisa-piutang-by-customer | existing | - |
POST /supplier/get-supplier | existing | - |
GET /customer | existing | - |
POST /financial-report/invoice-hutang-report | existing | - |
POST /financial-report/invoice-piutang-report | existing | - |